home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / exampleCode / stereo / opengl / README < prev    next >
Encoding:
Text File  |  1994-08-02  |  3.0 KB  |  63 lines
  1.  
  2.            ~4Dgifts/toolbox/src/exampleCode/opengl/stereo README
  3.    
  4.  
  5.      This directory contains four OpenGL/Motif programs: 
  6.      
  7.      boilerplate.c                   Basic X-Motif initialization routines 
  8.      clip.c                          clip demo with Motif Wrapper
  9.      simple_stereo.c                 Soft stereo example
  10.      simple_stereo_re.c              Quadbuffer Stereo example
  11.      
  12.      Each of these routines (clip, simple_stereo and simple_stereo_re) use
  13.      the Initialization routines found in the boilerplate.c file.  The
  14.      boilerplate demo creates a toplevel widget, then creates a 
  15.      GLwMDrawingArea in the toplevel widget, then clears the drawing area 
  16.      to black.
  17.      
  18.      The clip program is the clip demo found in the "OpenGL Programming 
  19.      Guide," p. 108, except it is drawn in a GLwMDrawingArea widget using 
  20.      the Motif library calls.  This demo draws a sphere and uses clipping 
  21.      planes to clip out portions of the sphere.
  22.      
  23.      The simple stereo routines (simple_stereo and simple_stereo_re) draw 
  24.      a cluster of 6 spheres using the gluSphere library.  The spheres are 
  25.      lit using a single light and the surface of the sphere is shiny.  The
  26.      cluster can be rotated by holding down the left mouse button and
  27.      moving the mouse.  These two programs can be placed in and out of
  28.      stereo mode by pressing the middle mouse button.  Simple_stereo will
  29.      be rendered in stereo by the X-server.  This is a software
  30.      implementation of stereo in a window for machines that do not have
  31.      the quad-buffering graphics hardware found on the Reality Engines.
  32.      The routine simple_stereo_re will invoke the Reality Engines
  33.      quad-buffers to render the stereo image in a window.
  34.      
  35.      Caveat:  Because the OpenGL libraries do not currently support the 
  36.           getmonitor command the state of the monitor cannot be 
  37.           saved before placing the monitor in stereo mode. To return
  38.           the display back to normal viewing the programs 
  39.           (simple_stereo and simple_stereo_re) invoke setmon -n 72HZ 
  40.           to bring the display out of stereo mode.  If your display 
  41.           cannot be set to the 72HZ refresh rate change 72HZ in the 
  42.           source to 60HZ and recompile by typing make.
  43.           
  44.               The program simple_stereo can only be run on a PI with GR2
  45.           graphics, an Indigo (XS-24, XZ and Elan) an Indy and
  46.           an Indigo2 that are running IRIX 5.2 or later.  An error
  47.           message that you would receive if you ran it on an early version
  48.           of IRIX is: "xxxx:simple_stereo: rld: Fatal Error: attemped
  49.           access to unresolvable symbol i\n simple_stereo: 
  50.           XSGISetStereoBuffer."  Here xxxx is the process id.
  51.  
  52.           The program simple_stereo_re can be run only on a 
  53.           Reality Engine running 5.1 or later.  If you were to run
  54.           it on a non-Reality Engine you would receive the error:
  55.           "Error: GLwMDrawingArea: requested visual not supported."
  56.  
  57.      
  58.      Neal A. Neuburger, Ph.D.
  59.      Member of Technical Staff
  60.      Chemical Applications
  61.      neal@sgi.com
  62.      415/390-5004
  63.